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PRODUCT SPECIFICATION 


REVISIONS 


“Original Issue -- Mark 10.0 Release . 


” Changes fa MARK 10.0 Release 
1-2 Added punctuation mark, 


1-4 Updated "ENTRY OF ADAPTER FOR TWA MODE" section to 
describe the changdng of adapter parameters at the 
start of the RSVP program, 


‘1-7. Updated "ENRTY OF ADAPTER FOR TWS MODE" section to 
describe the changing of adapter parameters at the 
start of the RSVP program. 


1-23 Changed title of section from "THE PARSING AND ACTION 
OF PARAMS" to "THE PARSING OF PBARAMS". 

Split "THE PARSING OF PARAMS" into two sections with 
"ACTION AFTER REQUESTING PARAMETER. ‘CHANGE ® as a 
subsection of this section. 

Updated "Case L" of the "ACTION AFTER REQUESTING 
PARAMETER CHANGE" section, | 
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| GENERAL 
RSVP (Remote System-Link. Verification Program) is a 
corporate-wide specificatton for writing | BOLC confidence 
progr amse The RSVP SDS specifies operator commands and test 
protocols for all systems that implement BNA/HDLC. There are a 
few areas in RSVP that are system dependents $ @CeGe» hardware 
identification. This document describes the system dependencies 


‘for the #81900. Refer to RSVP SOS (2228 2065) for a full 


description of RSVP. 


ji990 RSVP is a 81900 program designed to exercise the various 
operations associated with the BDLC hardware and ensure 
confidence in the communication between two remote. systems 
equipped with the BOLC hardware. Both normal and error detection 
conditions are verified to operate according to 681900 BDLC 
specifications. Frames are built according to BDLC protocol and 
are transmitted to the remote system. The frames are of varying 
length and character content. The process consists of 
transmitting the frames and then waiting for verification from 
the remote system. This ensures confidence that the two systems 
can send and receive properly. In the event of an error the 
program is designed to give evidence as to the fauity system and 
the cause when possible. Two copies of the RSVP may be executed 


in the same yee to effect back to back testing. 


There are two modes of communication possible: 
1) TWO_WAY_SIMULTANEGUS CTHS) dedicated full duplex 


2)  TWO_WAY_ALTERNATE (TWA) over switched half_duplex Lines 
a which may consist of MANUAL DIAL or an AUTOMATIC CALLING 
UNIT. — | 7 


Name | | Z | | _ Nugber 


RSVP“REMOTE SYSTEM-LINK VERIFICATION PROGRAM SOS 2228 2065 


ee 
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OPERATING INSTRUCTIONS FOR RSVP 


The program is executed by: 


PEX ROVP 
The following message appears after the start up of the program: 


texte REMOTE SYSTEM WERIFICATION PROGRAM» REVISION G ke ee 
CG will change to the current revision as the program is updated) 
A separate disk file called RSVP/TEACH must also be resident in 
order to use the TEACH command. a the file is not present then 
the operator is notified by? 


FILE RSVP/TEACH NOT eae 


This does not prevent execution of RSVP» but copoly means the the 


TEACH data for Rove are unavailable for uS@e 


Two program switches have significance to RSVPs Switch 1 and 
Switch Be If program switch 1 is set» avwary detailed trace of 


the RSVP software is recorded in a backup file called DEBUG.FILE. 


This is not a tool provided for use by the operator» our 1s for 
the purpose of helping to debug the RSVP program. | , 


The other switch » Switch 8» causes the reading and printing of 
the BOLC adapter‘s RAM whenever an exception bit is recorded. 
Again this is not a tool to be used under normal testing 
circumstances. The file catled PRINT.FILE is used for the 


recording of the data read. 


after the identification of the program follows. a message ae 


messages indicating the location of any data coma controls. An. 


CO 


example showing the existence of two data comm cont rots is: 


sex SLC ON PORT 7 CHANNEL 13 ##* 
ee MLC ON PORT 1 nee 


The ‘operator is then advised to enter the Location of the BDLC. 
adapter hy < | | | 


ENTER ADAPTER ADDRESS a FORMAT IS PORT: : CHANNEL: ADAPTER. 
IF YOU WANT TO GO TO EQJ» ENTER STOP 


C) 
Nw 


(173 
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If the control device is a Single Line Control then the Port must 


be 7» the Channet number may be any number from 0 to 14. The. 


Adapter number is always OQ. 


If the control device is a Mult? Line Controt then the Port may 
be any number from 0 to 6. The Channet number wit. always be 0 
and the Adapter number may be any number from O- to 15. 


If for any reason the adapter is in uses the operator witl be 
notified of its unavailability. The operator witt also be 
notified if there are any errors when entering the inforsation. 
The types of errors and how they are handled are discussed tn the 
error section. 


The next two sections discuss how to enter the adapter(s) for the 
desired mode and the results without errors. Following these 
sections is a section concerning the various errors and_ the 
messages that wiil be displayed accordingly. 


Or rrr an pg eee 
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ENTRY OF ADAPTER FOR TWA MODE 


If the mode is TWA the operator is required to enter only one 


adapter. The entered port» channet and adapter are_ then 
displayed and the operator is prompted for confirmation. 


Examples PORT 201 
| CHANNEL 3:00 
ADAPTER 3:02 | 
[IF THESE VALUES ARE CORRECT» ENTER *YES* 
IF NOT» ENTER *NO® AND YOU MAY REENTER THEM. 


If "YES* is entered the message appearing on the screen indicates 
the mode of the 8DLC adapter. | 


Example: 01200202 IS A TWA SWITCHED ADAPTER. 


As soon as the adapter type has been identified» the parameter 
values are written to the adapter. The next series of messages 
to appear on the ODT concern the current parameter values. The 
operator 1s first notified of these values by: | 


THE PARAMETERS READ FROM THE ADAPTER ARE: 


00 Axxxxa 
OL @xxxxe 
O02 Axxxxa 
03 AXxXxxa 
O8% AXKXKXd 
OS Bxxxxd. 
06 @xxxxa 
OF axxxxa 
08 Axxxxa 
99 Qaxxxxa 
10 dxxxxa 


The operator is then asked for further action by?) 


ANY CHANGES? ENTER YES O82 NO 


If the operator elects no changes» then a NO entered causes the 
program to continue. A YES causes another message indicating how . 
to proceed. The sessages and what actions to take are described > 
in Case 1 of the section on ACTION AFTER REQUESTING PARAMETER 


CHANGE. 


pO 
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| | . | , 3 | 
err next orompt for the TWA switched mode indicates that the 


CO 
Fes 


program ts tina state of Waiting for either a switched connection 
or pus by the operator. 


WAITING FOR SWITCHED CONNECTION OR OOT INPUT 


At this point the operator may wait for the Switched connection 
from the remote system Cauto answer) or cause the connecttons 


1) If the choice is to wait for the switched connection then at 
the time the connection is made» a wessage will appear 
indicating that a READ op has been put up and GOT input 1s 
acceptable. : 


READ OP PENDING OR WAITING FOR ODT INPUT 


2) If the choice is to establish the switched connection then. 


if the system its manual dial» the operator must complete the 
dialing. If the unit has an ACU then the operator must 
enter the CALL command and the number to be catted. The 
CALL command is further described in the RSVP. specifications 
$.-0.5S. 2228 2065. | a 


Example: CALL 964°97543 (Cdashes are optional) 


After the call has completed the program enters a waiting 
State and the message appearing on the screen is: | 


READ OP PENDING OR WAITING FOR ODT INPUT 


Cc. 
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ENTRY OF ADAPTERS FOR TWS NODE 
The following description is for the THS modes: 


The operator hast enter two adapter Locations: . one for read and 
one for write. Either one may be entered first. Upon the entry 
of the first one the message appears displaying the entry and 
asking for confirmation. 


Examples PORT 201 
CHANNEL 200 
ADAPTER 302 
IF THESE VALUES ARE CORRECT» ‘ENTER "YES* 
IF NOT» ENTER *"NO*® AND YOU MAY REENTER THEM. 


Upon confirmation a message appears indicating the adapter 


location» the mode of the adapter and whether it ts Read or 
Write. The operator is advised that a second adapter location is 
needed. | oo | , a 
( - Example: | a 
ee 3 01:00:02 IS A BOLC TWS LEASED WRITE ADAPTER 


BOLC TWS READ ADAPTER 15 REQUIRED. 
ENTER ADAPTER ADDRESS_FORMAT IS PORTS CHANNEL: ADAPTER 
IF YOU WANT TO GO TO EDS» ENTER STOP © 


The operator must enter the second adapter Location. After the 
second entry» the entry ts displayed as before and confirmation 
asked for. - | | - eo "ye 3 | 


Example: PORT 201 
_ CHANNEL 200 
ADAPTER 200 | | 
If THESE VALUES ARE CORRECT» ENTER "YES®* 
IF NOT> ENTER *NO* AND YOU MAY REENTER THEM. 
TF YOU WANT TO GO TO EOJ» ENTER STOP 


Hoon eantipeation a message appears with oe identity an the BDLC 
eceprers 


Example: 01200200 IS A BDLC TWS LEASED READ ADAPTER 


. 
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As soon as the adapter locations are knowns the parameters values 
are written to the adapters. The adapters are then read. Both 
the Read Adapter and Write Adapter parameters are displayed to 
the ODT. The Read Adapter parameters are displayed first. An 
example of the display 1s: | | 


THE PARAMETERS READ FROM THE READ ADAPTER ARE? 


09 200002 
O1 3FFFOQ 
02 202002 
03 aF000a 
04 201289 
05 aFFFFQ 
06 2000Aa 
a7 231284 
08 200002 
09 318002 
10 a03FFa 


After the disolay of the values the operator is prompted (for 
changes by: | | He 


ANY CHANGES 2? ANSWER YES OR NO 


C If changes are elected by entering YES» then the operator 
receives a further prompt as to how to enter the changes and the 
process to follow. This ts described in Case 1 of the section on 
ACTION AFTER REQUESTING PARAMETER CHANGE. The parameters for the 
Write Adapter are displayed next followed by the Same prompts as 
for the Read Adapter display. 


At this point the system waits until the Oata Carrier is 
activated by the remote systema and then puts up read ops. At 
completion a message appears on the ODT screen indicating the 
system is waiting to receive data from the remote system or ODT 
input: | | | a | 7 oe 


READ OP PENDING OR WAITING FOR ODT INPUT. 


Once this message appears on the screens the system is ready to 
receive any of the RSVP commands: or data sent from the remote 
system. | | | | 7 


To establish the system as the MASTER system in either modes Tt 
#S necessary to enter the RSVP command CONNECT>. If the system 
is to become the SLAVE syStem then the system must wait for a_ 
cOmmand sent from the remote system which is activated by the. 

entering of CONNECT? at the remote system. © The commands” that 

may be entered are described in full in une RSVP spect ications 
$eD.S.2 2228 2065. 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 


tng nnn pane nnn el 


(1-8 


COMPANY CONFIDENTIAL 
---BL900781800 RSYP 


SANTA BARBARA PLANT 


* 


PeSe 2228 3535 (8) 


ERROR MESSAGES 
The following is a list of error messages which may be displayed 


during the input of the adapter Location with a brief explanation 
as to the cause: 


1) NO INPUT RECEIVED» TRY AGAIN 
result of blank tine entered on ODT. 


2) EXPECTING =: NONE FOUND a 
wrong format for entry» a colon omitted. | 


3) PORT VALUE TOO LARGE OR NOT NUMBER OR LENGTH OUT OF RANGE 


number entered for port targer than 7» or a non-numeric 


value entered or the number exceeded two digits. 


4) MORE THAN ONE : RECEIVED 
| wrong format» more than one colton between numbers entered 


2) CHANNEL VALUE TOO LARGE OR NOT NUMERIC OR LENGTH OUT OF 


RANGE | 
number entered for channel was larger than 15» or a 
C) | non-numeric value entered or the number exceeded two digits. 
| } | | | | | 


6) CANNOT. HAVE A.NON“ZERO CHANNEL ON A PORT OTHER THAN PORT 7 
The controt is a Multi Line Control and the Channel nuaber 
must be 0. Only Port 7 may have a peng ee line controt. 


7) ADAPTER VALUE NOT NUMERIC OR LENGTH. ZERD —_ | | 
The Adapter value was a non-numeric value or none was 
entered. | ) a | a | 


8) LENGTH OF UNIT IS TON LARGE 
: The entry for the Adapter was more than two digits. — 


9) UNIT NUNBER 15 TOO LARGE (>15) 
The entry for the ‘Adapter was greater than 15. 


10) CANNOT HAVE A NON-ZERO UNIT ON PORT 7 | 
.The adapter number 1s always 0 on a Single Line Control 
which is Located on Port 7. 
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A command 
follows: 


i) 


3) 
CALL 


CANCEL 


CONNECT 


DISCONNECT 


DISPLAY 


; 
C ‘ 
Pol 
— 
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SYNTAX CHECKING AND PARSING OF COMMANDS 
entered during the execution of RSVP as processed as 
The tine is first checked for syntax errors. Any 
errors found cause the rejection of the entire tine. 


The portton tn error is displayed to the operator. 


A single command is then acted on if action is 


required. 


More than one command may be entered on a. tine and a 
Line containing multiple commands is parsed as follows: | 


The call nuaber is recordeds and the catl flag 
sete The regaining portion of the line is saved 
to be parsed tater and the calt acted on. 


If a test is in progress» or sending of a command 
which may be repeated is itn progresses the 
remaining portion of the line is cancelied » the 
Parser exited and the command activated. If no 
test is in progress and no retry is in progress 
then the CANCEL command is ignored and parsing 
continues. | : | 


The CONNECT flag is set. The remaining portion of 
the Line is saved. The parser is exited. The 
CONNECT ts then acted on as folftows: If the 
CONNECT 15 not active an att2mpt to connect is 
made, the attempt may be retried tif not 
successful. If the CONNECT has been established 
previousty and is of the type RSVP-RSVP» the 
operator 1s notified of the existing connection 

and type. If the type is RSVP-BNA then a new 
attempt to connect RSVP-RSVP its § mades if the 
connect remains RSVP-BNA the operator is notified 
of such. | ; | 


The DISCONNECT flag is set» the remaining portion 
of the Line is nullified» the parser exited and 
the disconnect activated. | | oo 


The DISPLAY parameter is set if indicated by +t or 


“3 otherwise» the status of the parameter is 
displayed Parsing of the Line continues. 


BURROUGHS CORPORATION 
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ECHO | The echo pattern ts extracted and -stored in oan 


_ EHALT 


GO 


PAUSE 


PRINT 


‘REPEAT 


REPORT 


RESET. 


RUN 


STATUS 


sToP 
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echo pattern queue. The next stot in the test 
queue is filled with a 99 to ‘indicate an _ echo 
teste Parsing of the Line continues. 7 

The EHALT parameter is set if indicated by + or <3 
otherwisepe the status of the parameter is 


displayed. Parsing of the line continues. 


If the 31 flag is set. the command 1s a no_op and 
parsing continuess otherwiser» the GO flag ts set 


and the remaining portion of the line is Saved. 


There 18 an exit from the Berseis to act on the 
command. | | 


The PAUSE value is set» the pause flag is set. 


Parsing of the Line continues. . 


Tne PRINT parameter is set if indicated by + or - 


atseh arose, Parsing of the Line continues. 


The REPEAT value is set as ‘indicated. The parsing 
of the Line continues. ) : 


If REPORT# ts entered» the report indicator 1s set 
to give a maximal report. If REPORT- is seto then 
the indicator is set to give a minimal report. 
REPORT entered without an indicator displays the 
REPORT setting and gives a report of the Last 
error according to the CEP ENs Parsing of the 
Line continues. - 


The RESET piaG is sety the remaining portion of 


the Line is nutlified and the parser exited for 
adios on the command. The command is a no_op on 


The RUN flag is set. If Master then the parser is 
exited for action on the command. The rematning 


portion of the line is saved. Tf Stave the 


command is ignored and the parsing continues. 


The STATUS information is displayed and includes 
the remaining portion of the Line to he parsed. 
Parsing continues. : 


The STOP flag is set» the remaining portion of the 
tine is nullified and the parser is exited for 


action on the command. 


The TEACH data are displayed. Parsing continues. 


; otherwisepr the status of the parameter is 


0 
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TEST 7 _ The test numbers are entered into the test queue. 


If more than one TEST command appears on the Line» 
the test numbers are entered in the queue in the 
Same sequence as they were entered .on the Lline> 
tee@e» TEST 1 -35% TEST 2—- 6% go into the queue 
as: LePoSe2esehen Sob0 Parsing of the Line 
continues. | | 


TIMEOUT The TIMEOUT value is recordeds | a timeout flag set 
| and parsing continues. -: | a 7 
TRACE The TRACE parameters are set» the trace started or 
3 | . turned off as indicated by + or =... FRACE entered 


With no parameters causes the status of TRACE to 
he displayed. Parsing continues. ae 


{t must be noted for the commands PAUSE» REPEAT and TIMEOUT that 
if entered subsequent to the RUN command» then they have no 
affect on those TEST*'s or ECHO'sS entered prior to the RUNS 
however» 1f any of these commands are entered prior to the RUN 
then any TEST or ECHN in the TEST queue will be executed under 


the conditions effected by these commands. 


If a test is running and new commands are entered. at the ODT» 


then the following is the method to be used for handling these 


new commands » 


The Line is checked for syntax errors and rejected if any = are 
found. The operator is notified of rejection and the portion. Of 
the line which was the cause of the rejection as displayed. 


There are two: possible conditions which may exist vat the time the 


‘command 1S entered: 


1) The previous command Line was saved. 


2) The previous command Line was completely parsed or nul Li fied. 


CASE 1: 


Actton is suspended on the previous command Line and the new Line 
is acted on one command at a time With the following 
consequencess : oe 


AD The following commands are acted on immediately as 
| previously described: — ee | 
JISPLAY> PRINT» REPORT» STATUS» TEACH» TRACE 


3) The following commands affect any remaining commands Ine 
the saved Line. 


PAUSE» REPEAT» TIMEQUT 
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E) 


F ) 


G) 
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The newly entered values will apply | to any of the 
TEST*s or ECHOD*®s rematning in the Test queue. 


The following ‘commands are acted on. as described 
previously and cause the nullifying ov the saved awn 


CANCEL» DISCONNECT» RESET» SEOP> CONNECT | 


The first encounter of either TEST or ECHO causes the 
RUN flag to be turned off and the test queue and_ the 
ECHO queue to he emptied. fhe saved Line is nullified. 
Subsequent occurrences of TEST or ECHO on the new tine 
are treated as described previously« —— 


If RUN is entered before any TEST or £CHO a message to. 


the operator indicates a test is running and the RUN is _ 


ignored. If RUN is entered subsequent to ECHO or TEST 
the procedure is as described previously. 


If CALL is entered and the CALL is actually required» 
then the previous Line is nutlified and the CALL 
processed as previously described. If no CALL is 
necessary then it is a no_op and parsing continues. 


At the completion of the new command tines if the saved 
line has not be nullified it is retreived for continued 
parsinge. : a | : 


The new command tine 1s_ processed as previously 
described. | : 2 
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ERROR MESSAGES FOR INCORRECT ENTRY OF COMMAND 


If a syntax error is committed upon entering a coemand at the ODOT 
the operator is notified by: a i. = | 


(#eeERRUR ee COMMAND LINE REJECTED 


then there is a display of the faulting command. For example: © 


OLSCONNECT HARS 


There 1S no other message. 


RUN TIME MESSAGES FOR INCORRECT ENTRY OF CONMAND 


There are two errors which can be considered run time errors. 


4) 


2) 


If the operator entered a test number which ts not valid for 
the 81909 system then when RSVP attempts to run the test» 
the error will be noted and the operator notified with the 
following message: 3 


INVALID TEST NUMBER 


If testing is under the RSVP to BNA connection then only the 


command ECHO with the desired test pattern is acceotable for 


testing purposes.) If the operator enters a TEST into the 
queue then RSVP notes the error and notifies the operator 
with the messaqe:. : | : 


CONNECT IS RSVP-BNA> ONLY ECHO IS ALLOWED. 


En nt ce ee eg RR Ge ae, a 


rare acme tanta tN tne 
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ERROR MESSAGES DURING RSVP EXECUTION AND DATA TRANSMISSION 


During the execution of RSVP» errors may occur. Failures’ may 


occur during transmisston of data» receiving of data or as a 


result of a dispatched operation to the &DLC adapter failing. 
When these fatlures occure the 81900 RSVP program analyzes the 
failure and a message is displayed on the ODF. Messages will be 
sent to the ODT or printer depending on the OFSPLAY and PRINT 
options. The detail of many of the error descriptions is 
determined by’ the (setting of the REPNRT option. (See section 
HL900 SYSTEM DEPENDENCIES. for the report format.) Each of these 


error messages 1s preceded hy “ERROR TEST nn. | The messages that 


may be. displayed and their probahle causes are: 


1 INVALID ADDRESS RECEIVED FROM THE REMOTE SYSTEM 
‘The address field of the received frame was incorrect... 


2) INVALID: COMMAND RECEIVED FROM THE REMOTE SYSTEM 


The command fietd did not contain a proper command. 


3) TIMEDUT OCCURRED ON WRITE 

: A write operation was dispatched and did not complete during 
the time allowed. The default timeout period 1s 10 secondss 
but the operator can change this time to any period desired 
using the TIMEOUT command. | 


4) YIMEQDUT OCCURRED | 
No operation dispatched has completed during a time period 
during which the operation(€s) dispatched should have 
completed. | : ~@ 3 7 | Ss 


3) EXCEPTION 317T SET ON READ _ Lo» * eee 
The read operation dispatched has completed with the 
exception bit set in the result descriptor. The result 

descriptor is displayed 1f the REPORT flag 185 one — 


6) WRITE OP COMPLETED» TIMENUT ON READ 


A write operation was dispatched and compteted without 
exceptions the dispatched read operation did not comptete 
during the time period allowed. | 


7) EXCEPTION BIT SET ON WRITE a = 
A write operation dispatched has completed with the 
exception bit set in the result descriptor. | The result 
descriptor is displayed if the REPORT flag is. on. | 


8) READ OP CUMPLETEDs» TIMEOUT ON WRITE 


>This would onty aoply to THS. Both a read operation and a 

write operation have been dispatched. The read = operation 
has completed normally, but the write operation a2? not 
completed during the time period allowed. : 


9) REMOTE SYSTEM RECEIVED A SAD FRAME 


This only applies when the system is. MASTER. The Stave has 


O) 
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10) 


14) 


O 


15) 


16) 


17) 


18) 


received a frame and found it not to match what was 


-expecteds or the frame had an Address field in error .or a 


Conmand field in error.s The Stave indicates this condition 
by sending a message'to the nasL ers | 


INVALLO TEST NUMBER RECEIVED FROM REMOTE SYSTEM 


The Slave has received a command from the Master to start: a 


test but the test is not vane for the. Slave system. 


INVALID’ FRAME LESS THAN 32 BITS _ 7 | 
At least two bytes of data must be sent to the BNLC: adapter. 


The BOLC adapter supplies a Frame Check sequence which is 2 


bytes Longs hences at least four bytes of data are sent by 
the BOLE ‘adapter. Fewer bytes cause an exception condition.se 


READ COMPLETED SUT No DATA RECORDED 


A dispatched read operation has completed without exceptions 
but no eokiad Was received. 


INVALID. FRAME REREIVED FROM REMOTE SYSTEM | 
The frame received from the remote system did not match what 
Was exoected and is not a | recognizable command or response. 


FRAME RETURN AFTER ELF INDICATED BUT NONE RECEIVED; TIME 
OUT a 
Tne Slave sent an EIF frame indicating an errore A pit was 


set in the EIF frame indicating that the faulting frame was 


to follow. The frame was not received during the tite — 


yeriod allowed. 


FRAME RETURN AFTER EIF INDICATED. BUT NONE RECEIVEDS 
EXCEPTION COND | 


The Stave sent an EIF frame nds eat ino a frase received in 


error. fhe bit indicating that the faulting ‘frame was to 


follow was set. The read operation dispatched for receiving. 


the frame completed with an exception bit set in the result 
descriptor. . | 


TIMEQUT ON READ | oe 3 2 | 
A dispatched read operation has not completed during the 
time pertod allowed. | oe 


NO I-FIELD RETURNED FROM REMOTE SYSTEM 


The frame returned from the remote systern was expected td 


contain an address fields a command field and an information. 


field. Only tne address field and ee field were 


returned. 


Nat A VALID TEST NUMBER FOR THE REMOTE. SYSTEM. 


An attempt to start a certain test in the Stave €sited 


because this is not a valid test in the Slave system. The 


Slave sent a negative acknowledgment to the Master to. 


indicate this. 
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( )199 NUT COMPLETED PROPERLY? NEW TEST STARTED. 

‘ The Stave system has received a command from the Master to 
start a new test while the previous. test has not been 
completed properly. : 


20) INCORRECT NCR) FIELD | | | | 
The NCR) field of either an RR response or and I_frame_ did 
not match the VCS) variable kept and updated by the system. 


21) INCORRECT NCS) FIELD 


The NCS) field of an I[_frame ara not match the VCR) eee 
kept and updated by the systeme 


22) UNASLE TO FORCE AN ABORT : | | 
RSVP has. attemnted to force an abort by setting a certain 


parameter in the BOLC parameter field. The abort did. not 
OcCUre | 


23) UNABLE TO TRANSMIT IOLE.} pantie CONDITION oe 
4 An operation to cause an idle sequence on a TWA Line was 
Baer The operation completed with: an EEceeeTene | 


24) UNABLE” To TRANSMIT IDLE. TIMEQUT | 7 
An operation to cause an idle sequence on a/TWA Line was 
: dispatched. The operation did not complete during the 
C) alloted time pertod. | : - £ 2 


25) INCORRECT I-FIELD RECEIVED FROM REMOTE SYSTEM 
| The frame received from the remote system contained an 
I-field that did not match the expected data.- 
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DC /AUDIT 


The entry of TRACE+ or TRACEt EXCEPTION causes execution of the 
utility program OC/AUDIT. The following is an explanation of the 
DC/AUDIT as used by RSVP. | | : 


When a dispatched data conm I0.comptetese RSVP writes information 
regarding the I190 into a disk file that can be printed by 
CC/AUDIT. fhe audit option for RSVP is controtted by use of the 
RSVP command TRACE. | | a 


The audit file» OC/AUDIT.FILE» is maintained as a circular disk 
file. When. this file ‘gets fitled>, the otdest record is 
overwritten with the new record. This approach: optimizes disk 
space and at the same time atlows the user to monitor att data 


comm {/0 activity. The utility programe OC/AUDIT» may be 


executed concurrently with the RSVP and prints records written 
into tne audit file. RSVP and DC/AUDLET maintain synchronization 
through a mailbox (record [0] of the audit file). DOC/AUOILT 
accepts several input parameters. The parameters -are set by RSVP 


according to the TRACE command. 


OO) 


ee 


“ ) 
( i rs 
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TRACE COMMAND AND OC/AUDIT FILE IMPLEMENTATION 


When TRACE# or TRACE* EXCEPTION is entered at the OOT. RSVP opens 
the file in be following manner e = 


OPEN AUDIT INPUT» OUTPUT.» LOCKs | , 
ON FILE MESSING < a new file is created> 
ON FILE LOCKEN <message 1s displayed as: 
FILE “OC/AUDIT.FILE™ LOCKED =. 


The FILE.LOCKED condition indicates that the file is inaccessible 
for outout because another data comm handler has opened it with 
the LOCK optionr-- under this circumstance the RSVP program 
displays the message as shown above = and ignores | the TRACE 
command. No two data comm handlers may write to the same audit 


file at the same time. This is enforced through the LOCK option. 


of the OPEN statement. 


The FILE MISSING condition indicates that the file is not 
present. RSVP then creates a new audit file. The file is closed 


with the LOCK option to ensure that it is a permanent file. It 


1s then reopened as described above by RSVP with the LOCK option. 
Though no more than one handler may write to the audit file>, 
ODC/AUDIT may -stitt access the audit file on a read only basis. 
If two audit sesssions are initiated concurrently» then the two 
data comm handlers must aecess different audit files; this may 
be accomplished through file equation. For RSVP this implies 
that if back to back testing is being done with two RSVP programs 
then if the TRACE option is to be used for both RSVP programse 
then a file equation must be done for at Least one of the audit 
fites. For example: | | | : : 


EX RSVP FILE AUDIT NAM REAUDIT | 


‘Record zero of the audit provides the mailbox between RSVP and 


DC/AUDIT.  $It contains two pointers.  START.POINTER and 


NEXT.AVAILABLE.RECORD. The former points to the oldest record in 


the file and the latter to the next available location in the 


audit file. Record zero also contains a count of atti valid _ 


vecords CRECORDS.WRITTEN) in the file. On the first OPENs RSVP. 


initializes NEXT.AVAILABLE.RECORD and START.POINTER to one and 
RECORDS.WRITTEN to zero. On subsequent opens» record zero 1S not 


Seeds 


The: operator may: contrat the writing to the audit file during the 
execution of RSVP by using TRACEt and TRACE-. The first TRACE+ 
causes . the opening of the file with the initialization of record 


zero. YRACE- causes the cessation of writing to the Audit file. 


A subsequent TRACE+ would start the recording - of the data comm 
communication once again. - 


cycled. In acycted file START. POINTER will be updated acm time 


yest} atten nnneneanraraninneiatinte sinning aaitpntesttinsptntetnn tiie inner nennniinpiansinmpmeninee met ih ne tarietetn yn ying iors ten amen ants ntti ett 
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When adding records to the audit file» RSVP writes the record to 
the location indicated by NEXT.AVAILABLE.RECORD. After each 
write, RSYP updates record (0) by rewriting it With 
NEXT.AVATLABLE.RECORD and RECORDS.WRITTEN. updated. If the number 


1719, 


of records written has caused the file to cycle (the number of | 


records written 1s greater than the file size (1000))» the oldest 


record will have heen overwitten and the START.POINTER ts set 


equal to NEXT.AVAILABSLE.RECORD to indicate that the file has 


the NEXT. Aes RECORD 1s updated. 


DE/JAUD(T is. run concurrent Ly with RSVP. This means. that it the. 


printer is on. and not in-use» then as the IU data is recorded: od 
DC/JAUDIT it will be printed. If OC/AUDIT catches up with RSVP 


waits for a short while. . When awakened SE PAUALE aceexaws. pacird 


zero to determine if there are any records to be printed. 


~ 
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RUN TIME PARAMETERS AND HOW CONTROLLED BY THE USE OF TRACE 


Upon execution of OC/AUDIT by RSVP» the program will look for a 
file tabeled “OC/PARAMETERS™ which contains the run time 
parameters for OC/AUDIT. DC/AUNIT witt read this file and 
process the parameters. The parameter file is created by RSVP. 
The parameters used by RSVP are: | | _ 4 


ADDRESS | Print port» channel ang adapter where I0 
oo DESCRIPTOR was dispatched. : 


ALL.LINES a Processes records in the audit file from att 
| | data comm lines included in the file. 


| BUFFERS | ‘ | Output atl buffers associated with to 


* ? 
eee 


DESCRIPTOR: and the continuation records. 
ERROR=C(1+3) | if ERROR=1» then OURDEr atl operations. 


If ERROR=3»5 then ignore alt operations that 
completed Without exceptions. & 3 


I0.DESC=(1),—(isé«<iiF«SsdOWDESCH=4e then orint “the entire Io 
te : | DESCRIPTOR in nee: with each field separated 
a by bLanks. 7 _ 

OUTPUT=(H) QUTPUT=H causes DC/ AUDIT to print all buffers 


with oan EBCDIC representation Das the 
hexidectaal code. | | | | 


EXAMPLES 20148 witl be paked as O1A8. 


If YRACE+ ts entered Dy the operator. RSVP first checks whether 
OC/AUDIT is currently being executed. If not» then the proper 
parameters are written into the parameter file and DC/AUDIT 
started. If OC/AUDIT is running then RSVP resets the parameter 
ERROR=1 to ensure that operations are recorded. If TRACE+ 
EXCEPTION ais entered» RSVP checks for DC/AUDIT itn progress and if 


not sets the parameter ERRDR=3 and starts OC/AUDIT. If it ts in 


progress then RSVP ensures that ERROR=3 its = set and nothing 


further is done. If either TRACE- or TRACE- EXCEPTION is 


entered» then no more data comm communication is recorded. — To 
start the recording once againe TRACE+ or TRACE EXCEPTION must 
be entered. The only difference between TRACE+# and TRACE 
EXCEPTION is that TRACE+ causes all operations to the data conm. 
devices to be recorded.  TRACE# EXCEPTION records only those 
operations which complete with an exception. | : | 
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THE OUTPUT FORMAT OF DC/AUDIT | 


The outout format of DC/SAUDOLT for RSVP is as follows: 


#*##*B1800/1700. DC/AUDIT <DATE TIME> seem 


TIME OP: QUFFER | NESCRIPTOR 

CNNSNNSNN  AAAAAA DATA |: AE=KKXXKK RS=XKKKKK LK =XKXKXX OPHKKKKKX 

Os te t# SAR MK KKK FARK KK MSE KKK OK KX 
t op type eo KXKMKX MHXKKK KKK KKX port:channel: adapter 
& : * LENGTH = nnnn Ao Le oe | 
* ‘te 3 e45 

. | | fe 

For read ope’ Data written or read. 

time op Data will be in | 

comoleted. | hexadecimal representation. 

For write op» 

time op | 


dispatched. 
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CHANGING THE BOLC ADAPTER PARAMETERS. 


The 3DLC adapter Marameters may be changed through the use of. a 
specific 31900 RSVP command. This command is entered like . any 
other command. The command and its consequences are: 7 | 


For the TWA wode» PARAMS is entered. For the TWS mode» either 


PARAMS for the read 30LC adapter» or PARAMS W for the write 
BOLC adapter 15 entered. | 7 


PARAMS may be entered at either the Master or the Slave system. 


The current settings of the parameters. are displayed to the 
operator. Yhe operator may then elect to change anys all or none 


of the parameters. After the operator has entered the changes» 
the parameters are again read and displayed to the operator. The 


operator may ‘again elect to change the paramaters or accept’ the 
changes. | | ie 


e 


eee 


C3 
a 
: \ 
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THE PARSING OF PARAMS. 


PARAMS 1s processed as follows: 

PARAMS is first checked Vek syacar error If the mode is TWS 
then R or Wis required. . Tf only PARAMS is entered then a 
message is displayed: — “oe | | 


"THE ADAPTER 1S NOT TWA. AN R OR A WES NEEDED" 


The command wilt he rejected in this case. If the mode is TWA 
mee the R or W if entered» is ignored. | 


ACTION AFTER REQUESTING PARAMETER CHANGE 


PARAMS may be entered under three possible conditions. These 
‘conditions and the actions taken are: : | 


Case 1. No test is running. 


The parameters are read from the BDLC aiapear and ientayed on 
‘the ODT. In TWS mode the display message identifies the adapter 
as the READ or WRITE adapter and displays: — 


THE PARAMETERS READ FROM THE READ/WRITE ADAPTER ARE: | 


‘In TWA modes the display message appears as? 


THE PARAMETERS READ FROM THE ADAPTER ARE? 


These display messages are followed by a linear display of all 


the parameters and their values. The values are in hexadecimal | 
representation. | | 
The operator is then queried for any changes by: 
ANY CHANGES? ANSWER YES OR NO" 
if ie operator wanted 2 poaauna of the pane ees and desires no 


changes» entering a NO will Leave the parameters as set and the 
RSVP program witl proceed normally. 7 
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Entering a YiS causes a display of instructions to the operator 
as to how the chanyes may be entered. The messages appearing 
are: 


ALL THE CHANGES MAY BE ENTERED aT ONCE. 
USE THE FOLLOWING FORMAT: : 

PARAMETER NUMBER IN DECIMAL FOLLOWED. BY : 
THE VALUE IN HEX AS: OD Q@NNNNQG DD aNNNNa ° 2 


The changes Sintered gre written to the 3DLC errs After they 
are written. The parameters are read once again and displayed in 
the Linear fashton described previously. The operator iS again 
queried about any more changes. An answer of NO: conttnues the 
RSVP program and an answer of YES again causes a” display of the 
entering format and cycles through the process agains 


COMPANY CONFIOENTIAL 


if the operation to change the Darameters fails then the sperator 


1s notified bys) 


ATTEMPT To CHANGE PARAMETERS sie 


Case 2. A test is running. 


If the PARAMS coamand was entered at. the Masters then the 


operator is notified that the test must be cancelled. After the 
test has been cancelled» the parameter changing process as 
descriosed ahove then takes place. If the operator does not wish 


to cancel the test» then the params process will occur at the end 
of the test. If PARAMS ts entered at the Slave» then the params 


process takes place when the test has ended or been cancelled by 
the Master. 


Cake 36 The program 1s in a waiting state due to EHALT setting» 
oe or the retry count has been exhausted sareng an attempted 
retry of certain conmands. | 


{[f PARAMS is entered» then the operator is notified in the case 


of Master that a CANCEL must be entered... If Slave then the 


operator is notified to wait until the end of the test. The 


operator may abort the PARAMS command by entering GO; 


O) 


(1925. 
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ERROR MESSAGES OURING PARAM CHANGE 


The parameter change entries witl be processed one at atime. If. 
an error occurss those changes prior to the error will be made 
and the operator notified of the error and the remaining entries 
displayed. Those entries subsequent to the error will not be 
changed and must be reenterede 


The error messages and their meaning are: 


1) PARAMETER. NUMBER IS MISSING PORTION OF LINE NOT PARSED: 
(the portion of the line not parsed is ia aad 


The number of the perawetor to be changed was. ‘not Rae ee oe: 


2) THE 2 SEGN IS MISSING Cthe portion of sk Site een 


displayed) 

The number of the parameter Was not followed by an 2 sign. 

3) ONLY TWO DIGITS ARE ACCEPTED FOR’ THE PARAMETER NUMBER. 
— PORTION OF THE LINE NOT PARSED: ° (the portion of the tine 
not parsed is displayed) | 


The number of parameters ranges currently from 0 to 10» if’ a 
number Larger then two digits is entered» it is an errors: 


4) NOT A VALID PARAMETER NUMBER PORTION OF THE LINE NOT PARSED: 


Tne parameter number entered is not in the range from 0. to 
10. | | | | 


5) PARAMETER VALUE IS MISSING PORTION OF THE LINE NOT PARSE: 


The parameter quaber was not followed by a par ameter value 
in hex and delineated by @ signs. | | , 


Poiana Dr ae pro oe ees Sac 
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B1900. SYSTEM DEPENDENCIES | 
The files which may be. referenced by RSVP and their functions 
are: | . — | me 
Internal name External name Purpose | 
OEBUG.FILE. = —- DEBUG. FILE Used for recording a trace 
) | | of the RSVP program. Not 
for general use. 
PRINT.FILE |  PRINT.FILE To be used for recording 
“a | -_ | data when the print ag. 
- 9S One 
TFILE : RSVP/TEACH The teach data is stored in | 
a | this file and the file is 
referenced whenever the TEACH 
command is-entered. 
_-. AUDIT DC/AUDIT.FIL | “Used by DC/AUDIT for the 
( \ | | | recording of completed | 
~-. a a | dispatched operations to the 
| BOLC adapter. Thus ail data 
transmitted and received 
through the. BOLC adapter. 
are recorded. 

The PAUSE time and the format of the error reporting were 
described in the RSVP specification as system dependent. The 
manner in which they are handled by the 81900 RSVP is as follows: 

1) PAUSE time entry indicates 10th of seconds’ hence» . 
PAUSE 5; would cause a delay time of 5/10 of one 
second. The maximum time detay allowed ts 1677215 
tenths of secondss t-.e@. In hex» aFFFFFF a. | 
2) The retry count for those com@ands which may be retried | 
is 5. | | 
3) The implementation of the. full report of an error. 
CREPORT +) 1s done in the following manner: : 
‘If Master 
*e REPORT GENERATED FOR MASTER as 
‘ | | | 
| C). otherwise 


* REPORT GENERATED FOR SLAVE #* 
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~~ 


( 


ea | The error and the test in which it occurred: 
ERROR _ TEST nn Cerror message) 
The: expected frame if there is any: 


EXPECTED FRAMES — : 
(display of the frame tn hexadecimal representation): 


If the error is not due to a timeout or an exception 
then the faulting frame is displayed: 


RECEIVED FRAME: 7 | 
(display of the frame in hexadeciaal representation) 


If the system is the Master and if the Slave returned. 
an €IF frame then the EIF status bits are displayed. 
The Stave never cd ELF status bits. ae 


INCORRECT A-FIELD CON or OFF) 

INCORRECT C-FLELD CON or OFF) 

INCORRECT I-FIELD ~~ ‘CON or OFF) 

SHORT FRAME CON or OFF) 

: os FCS ERROR CON or OFF) 
on | ABORT DETECTED (ON of OFF) 
e oan NON OCTET. I_FIELD CON or OFF) 

| 43 I_FIELD TOO LARGE CON or OFF) 
WINDOW SIZE ERROT CON or OFF) 

NO SPACE CONDITION CON or OFF) 


IDLE NOT DETECTED CYWA) CON or OFF) 


O 


OO) 
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If an 
displayed as: 


or 


or 


or 


or 


If the disptay flag is on » 


exception 


OP COMPLETE | 
EXCEPTION CONDITION 
OVERRUN ERROR 

FRAME AGORT REQUESTED 
FCS ERROR © _ 
DATA ACCESS ERROR 


MEMORY PARITY ERROR 


TIME OUT 


OUTPUT FRAME ABORTED — 


INPUT FRAME OVERRUN - 


LONG RECORD CNO END) ~— 


SHORT FRAME 
ABORTED INPUT FRAME 
IDLE DETECTED 

OSR LOST | 

LOSS OF CARRIER 


LOSS OF CLEAR TO SEND ~ 


INVALID OP 
NON OCTET I_LFIELD ~ 


then if the 


re 
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or 
.or 
on 
or 
or 
or 
or 


ee 
or 
or 
or 
or 
or 
or 
or 


or 


or 


OFF) 
OFF) 


OFF) 


OFF) 
OFF) 
OFF) 
OFF) 
OFF) 
OFF) 
OFF) 
OFF) 
OFF) 


OFF) 


OFF) 
OFF) 
OFF ) 
OFF) 


REPORT- _ 


h 


occurs then the result descriptor is 


read) 
write) 


write). 


read). 


write) 


read) 


read) 
write) 


as 


been set» then onty the following message is displayed: 


ERROR _ TEST nn Cerror message) 


If the display flag has been turned off by the operator 


then there would be 


occurred. 


no 


display indicating 


an 


err 


or 


4 
2 
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